home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 1 / Assassins - Ultimate CD Games Collection (1994)(Weird Science)(Track 1 of 2)[!][Amiga-CD32-CDTV][CDD5332].iso / instructions / misc / lines < prev    next >
Text File  |  1994-03-04  |  11KB  |  300 lines

  1. Lines 2.3 Documentation
  2. ***********************
  3.  
  4. Copyrights and fees
  5. *******************
  6.  
  7.    LINES is completely done by Mika Kortelainen and is copyrighted
  8. 1992-1994.  LINES is SHAREWARE, suggested fee is $5 or 20-30 Finnish
  9. marks (FIM). Please, send only cash because cashing foreign cheques is
  10. more expensive than the suggested fee. Because this archive contains the
  11. full, un-restricted version of the game, do not wait any return mail
  12. from me. But, by indicating your interest, you will get me to continue
  13. to develop LINES further (and release new versions).
  14.  
  15.    LINES uses several additional shared-libraries, which are
  16. copyrighted as follows:
  17.  
  18.               medplayer.library is (C) Teijo Kinnunen.
  19.  
  20.               powerpacker.library is (C) Nico François.
  21.  
  22.    Amiga, Workbench and AmigaGuide are registered trademarks of
  23. Commodore-Amiga, Inc.
  24.  
  25.    Other trademarks are the property of their owners.
  26.  
  27. Disclaimer
  28. **********
  29.  
  30.    The author will not take any responsibility about caused harm or
  31. ruined mental health LINES may bring about. You use LINES at your own
  32. risk.
  33.  
  34. Distribution
  35. ************
  36.  
  37.    LINES may not be distributed commercially without author's written
  38. permission (be ready to pay something to get a permission). LINES may
  39. be distributed freely as long as no essential parts of the original
  40. archive are removed and no more than a nominal copying fee is required.
  41. LINES may be included in disk collections such as Fred Fish's one and
  42. in CD-ROM collections, too.
  43.  
  44.    The original archive consists of the following files:
  45.  
  46. Lines
  47.      This is the game itself (PAL version).
  48.  
  49. LinesNTSC
  50.      This is the NTSC version of the game.
  51.  
  52. Lines.info and LinesNTSC.info
  53.      These are the corresponding icons for easy startup from Workbench.
  54.  
  55. Lines.doc and Lines.doc.info
  56.      This file as an ANSI text file.
  57.  
  58. Lines.dvi and Lines.dvi.info
  59.      This file as a DVI-file.
  60.  
  61. Lines.guide and Lines.guide.info
  62.      This file as an AmigaGuide file.
  63.  
  64. Lines34.guide and Lines34.guide.info
  65.      This file as an AmigaGuide (version 34) file.
  66.  
  67. libs/medplayer.library
  68. libs/powerpacker.library
  69.      The additional shared-libraries.
  70.  
  71.    The NTSC version has some distortions in logos and such, but the
  72. actual playing board should be fine (I hope).
  73.  
  74. Requirements and installation
  75. *****************************
  76.  
  77.    An Amiga computer (anything from 500 to 4000), TV or monitor, and a
  78. mouse are required to play LINES successfully. LINES uses
  79. medplayer.library to play MED modules. Powerpacker.library is
  80. needed if you intend to use packed modules. Most of you will already
  81. have these libraries in LIBS: (at least owners of harddrives) but
  82. they are included in the archive and can be copied if needed.  Besides,
  83. printer.device is needed if you want to get hardcopies of your games
  84. (and also, you should have set the printer preferences using system
  85. software).   LINES is tested on my A3000 (with OS1.3 and OS2.04), and
  86. it works on OS3.x, too. Tested also an Amiga 2000 (OS1.3, 512kB fast,
  87. 512kB chip). I don't know about OS1.2 (does it differ significantly
  88. from 1.3?), but give it a try!
  89.  
  90.    Memory requirements: the program itself doesn't need much (some Chip
  91. memory for the mouse pointer and graphics and other memory--which can
  92. also be Chip memory--for the actual code), about a total of 150
  93. kilobytes. The final memory usage depends on you: whether you want to
  94. listen to the music or not!
  95.  
  96.    LINES can be installed on harddrive and does not need any additional
  97. setting up--just copy the files (especially Lines and Lines.info or
  98. NTSC equivalents) to the destination. LINES will use the same directory
  99. when reading or writing settings and hiscores (it locks the directory
  100. at startup; if the lock fails, then S: is tried as an alternative).
  101.  
  102. First steps
  103. ***********
  104.  
  105.    LINES can be started from CLI or Workbench. From CLI, you can give
  106. it as an argument the name of the MED module you want to use. If it
  107. appears to be packed with PowerPacker, it is unpacked to your Ram Disk
  108. and loaded from there. From Workbench, you have two ways to select the
  109. music: the first is to give it as a tooltype SONG (i.e. set tooltype
  110. `SONG=device:path/modulename' using Info or Information from the
  111. Workbench menus), the second is to click first on the icon of the
  112. module and then, pressing Shift, to start LINES double-clicking on its
  113. icon.
  114.  
  115.    The original archive doesn't include any musics, because I'm not so
  116. good to compose (it is allowed to distribute the archive with some MED
  117. modules provided that they are public domain or freely distributable).
  118.  
  119.    LINES is completely played with the mouse, so there is no need for a
  120. joystick.
  121.  
  122.    At startup, LINES tries to read its settings and hiscore files
  123. (named Lines.Settings and Lines.TopLiners). If settings are not
  124. found, then the default ones are used. If environment variable USER
  125. exists, its contents are used as a default name, otherwise a hardcoded
  126. name is set (it can be changed from the program, of course).
  127.  
  128.    After loading you will see the game screen and logo at the centre.
  129. Click on MORE gadget. You will see an info page which shortly tells
  130. you the rules and the idea of LINES. Click on OKAY gadget to continue.
  131.  
  132.    Now you are ready to play but let's first study all the menus.
  133.  
  134. Menus
  135. *****
  136.  
  137.    Click on the right mouse button and move pointer to window title to
  138. see the menus.  There are three main menus named ProjectEdit and
  139. Settings. In the Project menu you will find items New GameTop
  140. Liners, PrintAbout and Quit, in the Edit menu items Help and
  141. Undo and in the Settings menu items Setup and Music. Almost every
  142. item can be used by its first letter (e.g. About by pressing 'A'),
  143. either upper or lower case. The only exception is item Help, its
  144. abbreviation is the HELP-key.
  145.  
  146. New Game
  147.      Starts a new game.
  148.  
  149. Top Liners
  150.      Shows the list of the 10 best players.
  151.  
  152. Print
  153.      Prints the screen to paper using your current Preferences
  154.      settings. During printing the screen colours are changed to white
  155.      and black. You can cancel printing with ESC-key at any time.
  156.  
  157. About
  158.      Shows the starting logo and info.
  159.  
  160. Quit
  161.      Quits the game (if TopLiners file has been changed, it is saved).
  162.  
  163. Help
  164.      Shows a point belonging to a line (normally, it's at the either
  165.      end of that line).
  166.  
  167. Undo
  168.      Undoes the last selection (see below for more info).
  169.  
  170. Setup
  171.      is used to affect LINES' colours. Click on the desired colour
  172.      gadget and use sliders to change the colour. You can also set a
  173.      default name which is automatically placed on Top Liners list.
  174.      Click on SAVE to save your settings, DEFAULT to choose
  175.      original (doesn't restore the name) or USE to use changes without
  176.      saving.
  177.  
  178. Music
  179.      Stops and continues the music (if music was loaded). It is
  180.      disabled if there is no music.
  181.  
  182.    On the right-hand side of the screen there is a table from where you
  183. can see your amount of Lines, Extras, and the Best result.
  184.  
  185.    For quicker use, UNDONEW GAME, and MUSIC can be chosen from
  186. gadgets below the score table, the functions are the same their menu
  187. equivalents have.
  188.  
  189. The rules
  190. *********
  191.  
  192.    And now to the main thing - the idea and rules of LINES.
  193.  
  194.    The idea is simple: draw as many lines as you can!
  195.  
  196.    Of course, there have to be several rules:
  197.  
  198. RULE ONE:
  199.      Only eight directions (horizontal, vertical, and diagonal) are
  200.      allowed.
  201.  
  202. RULE TWO:
  203.      A line is exactly five points long.
  204.  
  205. RULE THREE:
  206.      To draw a line, there must exist at least four old points which
  207.      are not used in that direction. The fifth point may be either at
  208.      the either end of the line or somewhere between the older points.
  209.      Of course, it is allowed to draw a line through five old, unused
  210.      points.
  211.  
  212. RULE THREE, supplement:
  213.      If the line is drawn without drawing any new point, you will get a
  214.      bonus point, called Extras (and a normal point, of course).
  215.      Later you can set that Extras point in any position you want and
  216.      perhaps play a little longer.
  217.  
  218. The playing
  219. ***********
  220.  
  221.    And how to play? No problem, just click on the point from where you
  222. want to start your line (if it is not valid, the screen will flash).
  223. Move mouse to the direction you want to draw the line (if it is a
  224. possible direction a blue line is shown). By moving mouse around, you
  225. can see all the possible lines from that point. When you have made your
  226. selection, click again and you have got a line as well as one point.
  227.  
  228.    After setting the starting point, you can cancel the selection by
  229. pressing UNDO (you can notice this easily: the gadget is normally
  230. disabled and comes enabled only when it can be used. The same is done
  231. to the menu item).
  232.  
  233.    To use an Extras, click twice on the same place and the point is
  234. plotted. If the position is illegal, screen will flash after the first
  235. click (because the program cannot know whether you are really going to
  236. use an Extras or just clicking on a wrong position), but after the
  237. second click the Extras is set. You can't undo any Extras!
  238.  
  239. At the end
  240. **********
  241.  
  242.    After a few games you will learn the play tactics and get better
  243. results, and you have a new obsession...
  244.  
  245.                               LINES!
  246.  
  247. Brief history
  248. *************
  249.  
  250.    The development of LINES started about two years ago and got
  251. finished in few months. It was my first Amiga program, and mainly done
  252. to learn C language (I had just got my registered DICE). As time
  253. passed, some bugs arose and were fixed. Until now,  LINES has been just
  254. for my private use. During the winter vacation I had time to `polish'
  255. the game (although software is never final...) and decided to release
  256. it to the public.
  257.  
  258.    Version 2.3 is the second release (only a bug-fix release).
  259.  
  260. The author
  261. **********
  262.  
  263.    Send fees, suggestions and bug reports (none known :-) to the
  264. following address:
  265.  
  266.              Mika Kortelainen
  267.              Petäjätie 13
  268.              FIN-35100 Orivesi as.
  269.  
  270.    I can also be reached through email at the following address:
  271.  
  272.              k125374@cs.tut.fi
  273.  
  274. The future
  275. **********
  276.  
  277.    Some enhancements I have in my mind:
  278.  
  279.   1. various different boards (suggested by Jimmy Ljungberg). This will
  280.      most likely be the next enhancement I make.
  281.  
  282.   2. the game in a Workbench window
  283.  
  284.   3. super bitmap window (i.e. scrollable game board)
  285.  
  286.   4. load/save game
  287.  
  288.   5. use of Screen database (or cloning of Workbench screen), so that
  289.      users of various graphics boards could get some benefit
  290.  
  291.   6. time game (a certain time period in which a line is to be drawn;
  292.      otherwise, one line (or point) is subtracted)
  293.  
  294. Fixes
  295. *****
  296.  
  297.   1. Border checking didn't always work. Now it should work. Reported by
  298.      Jimmy Ljungberg.
  299.  
  300.